Clarify docs. (#353423, Christian Persch)

2006-12-29  Matthias Clasen  <mclasen@redhat.com>

        * gtk/gtkstyle.c (gtk_style_attach): Clarify docs.  (#353423,
        Christian Persch)

diff --git a/ChangeLog b/ChangeLog
index b234e26010aba5645784bd0623519fc734c41842..a4c6ffcca41a1f35632c2a0c5eed0b9114b2b989 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2006-12-29  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkstyle.c (gtk_style_attach): Clarify docs.  (#353423,
+       Christian Persch)
+
        * gtk/gtkentry.c (blink_cb):
        * gtk/gtktextview.c (blink_cb): Don't die in an assertion
        if focus went missing. Just warn, clean up and continue.

diff --git a/gtk/gtkstyle.c b/gtk/gtkstyle.c
index b7d1d8f0a8d919700e2eebd1604973261cb7eba0..ed35c6c07fa97306de86da7bf536070742b485fb 100644 (file)
--- a/gtk/gtkstyle.c
+++ b/gtk/gtkstyle.c
@@ -678,10 +678,6 @@ gtk_style_new (void)
  * gtk_style_attach:
  * @style: a #GtkStyle.
  * @window: a #GdkWindow.
- * @returns: Either @style, or a newly-created #GtkStyle.
- *   If the style is newly created, the style parameter
- *   will be dereferenced, and the new style will have
- *   a reference count belonging to the caller.
  *
  * Attaches a style to a window; this process allocates the
  * colors and creates the GC's for the style - it specializes
@@ -692,7 +688,12 @@ gtk_style_new (void)
  * Since this function may return a new object, you have to use it 
  * in the following way: 
  * <literal>style = gtk_style_attach (style, window)</literal>
- **/
+ *
+ * Returns: Either @style, or a newly-created #GtkStyle.
+ *   If the style is newly created, the style parameter
+ *   will be unref'ed, and the new style will have
+ *   a reference count belonging to the caller.
+ */
 GtkStyle*
 gtk_style_attach (GtkStyle  *style,
                   GdkWindow *window)